Comment on page
Setting up an Explore Terrastories server
These pages may require some technical knowledge about server hosting and deployment. If the content of this page feels unfamiliar to you, get someone acquainted with information technology (IT) to help you.
The EXPLORE TERRASTORIES tool is a separate open-source application from the main Terrastories application, and requires a separate server setup. In short, Explore Terrastories queries a Terrastories server API which provides access to any unrestricted stories, which are the stories that may be accessed by a
viewerrole. (See Setting up users and roles for more information on roles and permissions).
You can spin up your own Explore Terrastories server and set it up to work with your own Terrastories server API. The Terrastories server API is protected through a CORS policy, and you have to provide environmental variables in both the Terrastories server AND the Explore Terrastories server in order for your Explore Terrastories application to have permission to access the API. Please see the Github repository for more information.
Create React App is a widely supported framework and there are detailed instructions on how to deploy Create React App on many environments including AWS, Azure, Firebase, Github Pages, Heroku, Netlify, Vercel, and more.
Once you have an Explore Terrastories server set up, you can enable communities to opt-in to using it by way of adding a
public_communitiesfeature flag. You can chose to enable it for your entire Terrastories server, a group of communities, or per each individual community.