Try out the latest build at latest-master.trotto.dev. If you'd rather use a fully-managed instance of Trotto, check out www.trot.to.

Don't hesitate to reach out to us through help@trot.to, a GitHub issue, or live chat at https://www.trot.to.

You can bring up a local instance of Trotto within a few minutes.

Follow the instructions here to install the Cloud SDK for Google Cloud Platform.

Once you've installed the SDK, you should be able to successfully run gcloud info.

git clone git@github.com:trotto/go-links.git
cd go-links

From the server/ directory, run:

./install_deps.sh
./run_local.sh

In a separate terminal, from the frontend/ directory, run:

npm install
./start_dev_server.sh

Now, you can access the local instance at http://localhost:5007.

Most server-side and frontend changes should be picked up automatically, thanks to the App Engine dev server and React Hot Loader.

Access the development admin console at http://localhost:8095. The admin console allows you to view the datastore, use an interactive console, and more.

Authentication: At the moment, the open-source app solely supports authentication using a Google account, but we plan to add support for additional identity providers as requested. So if you need support for another provider, submit a GitHub issue, and we'll help you out!

You can deploy your own instance to Google App Engine in around 15 minutes. If you have any trouble, contact us through any of the channels mentioned above, and we'll get back to you ASAP.

If you don't already use Google App Engine, sign up through https://console.cloud.google.com/freetrial.

Go here and create a new Google Cloud Platform project, then create a new App Engine application in that project. See this screencast.

Be sure to note your GCP project ID, which is shown when you create a new project and is also visible in the GCP console URL, as the project= query parameter. For example, in the screencast above, the new project's ID is trotto-test-7.

To support Google authentication, you need to create OAuth client credentials to include with your app. See this screencast.

• Your authorized domain will have the format PROJECT_ID.appspot.com (example: trotto-test-7.appspot.com)
• Your authorized redirect URI will have the format https://PROJECT_ID.appspot.com/_/auth/oauth2_callback (example: https://trotto-test-7.appspot.com/_/auth/oauth2_callback)
• You'll need to download a credentials file as shown in the screencast and rename it client_secrets.json

git clone git@github.com:trotto/go-links.git
cd go-links/server

Install the Google Cloud SDK using the instructions here.

Once you've installed the SDK, authorize the SDK to access your GCP project:

gcloud auth login

Inside the go-links/server directory, create and enter a Python 2 virtualenv:

cd go-links/server
virtualenv --python=/usr/bin/python2.7 .virtualenv/
source .virtualenv/bin/activate

From the same directory, run:

pip install -r requirements.txt

Take the credentials file you generated above (which should be renamed to client_secrets.json) and put it in the server/src/config directory.

Now, you can deploy the app. From the server/ directory, run:

./deploy.sh

After a successful deploy, you'll be able to access your Trotto instance at https://PROJECT_ID.appspot.com!