Getting started

Quick install guide

First of all, you have to clone the repository:

git clone https://github.com/doccano/doccano.git
cd doccano

To install doccano, there are three options:

docker pull doccano/doccano

docker-compose pull

First we need to install the dependencies. Run the following commands:

pip install -r requirements.txt
cd app

Next we need to start the webpack server so that the frontend gets compiled continuously. Run the following commands in a new shell:

cd server/static
npm install
npm run build
# npm start  # for developers
cd ..

Let’s start the development server and explore it.

Depending on your installation method, there are two options:

First, run a Docker container:

docker run -d --name doccano -p 8000:80 doccano/doccano

Then, execute create-admin.sh script for creating a superuser.

docker exec doccano tools/create-admin.sh "admin" "admin@example.com" "password"

We can use docker-compose to set up the webpack server, django server, database, etc. all in one command:

docker-compose up

Now, open a Web browser and go to http://127.0.0.1:8000/login/. You should see the login screen:

Before running, we need to make migration. Run the following command:

python manage.py migrate

Next we need to create a user who can login to the admin site. Run the following command:

python manage.py create_admin --noinput --username "admin" --email "admin@example.com" --password "password"

Developers can also validate that the project works as expected by running the tests:

python manage.py test server.tests

Finally, to start the server, run the following command:

python manage.py runserver