Deploying to Heroku is the easiest way to get your own instance of Trotto up and running, in minutes. Heroku provides a server and a database, and all you need to do is:
- Generate a secret for signing cookies and tokens
- Create Google OAuth credentials
Click the "Deploy to Heroku" button and follow the guide below to set up your instance.
Generating a strong secret
If you have Python installed, you can run the following to generate a strong secret:
python -c 'import os; import base64; print(base64.b64encode(os.urandom(32)))'
Once you've generated a strong secret, paste it into the
FLASK_SECRET section of the Heroku app
Creating Google OAuth credentials
See this page for info on how to create OAuth credentials.
Once you've created new credentials, download the JSON file for the credentials as shown
in the screencast and paste the JSON from the file into
GOOGLE_OAUTH_CLIENT_JSON section of the Heroku app creation screen.
Once you've set the
GOOGLE_OAUTH_CLIENT_JSON config vars on the app creation screen, click "Deploy
app", and your new Trotto instance will deploy and be ready for use.
If you have any trouble, don't hesitate to reach out to us at firstname.lastname@example.org.
Forking and automating deployment
You can fork the Trotto repo and set up your own deployment process in Heroku:
- Create a public fork, or a private mirror as described below
- Under the Deploy tab of the Heroku dashboard for your Trotto instance, connect the app to your fork/mirror and set up automatic deploys as described in Heroku's docs
- (optional) If you want to add additional config to your Trotto instance (such as a list of admins), create
app.ymlconfig file and set the base64-encoded
app.ymlfile as the
TROTTO_CONFIGenvironment variable as described in the
Creating a private repo
To set up a private repo mirroring the
trotto/go-links repo, create a private repo (without any initial files)
and run the below git commands, substituting your repo in the
git remote add origin ... command.
git clone email@example.com:trotto/go-links.git cd go-links git remote rename origin upstream git remote add origin firstname.lastname@example.org:YOUR_ORG/YOUR_REPO.git git push origin
Your new repo will now mirror the
master branch of