Skip to content

Creating users

Regardless of the installation method, you'll need to create some users. GoToSocial currently doesn't have a way for users to be created through the web UI, or for people to sign-up through the web UI.

Using the CLI, you can create a user:

$ gotosocial --config-path /path/to/config.yaml \
    admin account create \
    --username some_username \
    --email \
    --password 'SOME_PASSWORD'

In the above command, replace some_username with your desired username, with the email address you want to associate with your account, and SOME_PASSWORD with a secure password.

If you want your user to have admin rights, you can promote them using a similar command:

$ gotosocial --config-path /path/to/config.yaml \
    admin account promote --username some_username

Replace some_username with the username of the account you just created.


When running these commands, you'll get a bit of output like the following:

time=XXXX level=info msg=connected to SQLITE database
time=XXXX level=info msg=there are no new migrations to run func=doMigration
time=XXXX level=info msg=closing db connection

This is normal and indicates that the commands ran as expected.


When running GoToSocial from a container, you'll need to execute the above command in the conatiner instead. How to do this varies based on your container runtime, but for Docker it should look like:

$ docker exec -it CONTAINER_NAME_OR_ID \
    /gotosocial/gotosocial \
    admin account create \
    --username some_username \
    --email \
    --password 'some_very_good_password'

If you followed our Docker guide, the container name will be gotosocial. Both the name and the ID can be retrieved through docker ps.