> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ardoiseeduc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Diagnosing the most common problems with an Ardoise installation.

<Note>This page concerns Ardoise School in the OHADA scope, subject to enabled modules and permissions. School, school accounting and payroll are not offered in Austria. Check local requirements; CountryConfig does not certify compliance.</Note>

## Check that the server is running

```bash theme={null}
curl http://localhost:8000/health/
```

A `{"status": "ok", "version": "..."}` response confirms the container is answering. No response? Check that the container is running:

```bash theme={null}
docker compose ps
docker compose logs app
```

## Everything redirects to a "Welcome to Ardoise" screen

This means the installation has not been activated yet (or has lost its configuration). Go back through the [setup wizard](/en/guide-technique/installation) with your activation code, then restart the container.

## Staff cannot sign in from the SaaS portal

<AccordionGroup>
  <Accordion title="CORS error visible in the browser console">
    Your server's address (the tunnel hostname, determined automatically by the Platform and shown read-only under API Integrations) must match exactly the one staff use to connect to it.
  </Accordion>

  <Accordion title="The server is unreachable">
    If staff are working outside the school's network, direct access by local IP will not work - see [Remote access](/en/guide-technique/acces-distant).
  </Accordion>
</AccordionGroup>

## Mobile Money payments are not being confirmed

Check that the FedaPay webhook secret configured under **API Integrations** matches exactly the one shown on your FedaPay dashboard - an invalid signature causes the payment confirmation to be rejected silently (the payment stays "pending" on the Ardoise side even though the parent has paid).

## "No tunnel token returned" when starting the tunnel

The Cloudflare tunnel has not yet been activated or correctly associated with your school. Go back through the steps in [Remote access](/en/guide-technique/acces-distant).

## Automatic backups seem to have stopped

The Google Drive connection has probably expired or been revoked. Reconnect it from your founder dashboard (see [Backups](/en/guide-technique/sauvegardes)).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.