Quickstarts
Java Server Quickstart
Get started quickly with Ditto using the Ditto Quickstart Applications
Prerequisites
Following are the minimum requirements that must be met before attempting to install Ditto.
-
Java Development Kit (JDK) version 17
-
One of the following platforms and architectures:
- Windows x86_64
- MacOS arm64 (Apple Silicon) or x86_64 (Intel)
- Git installed on your machine
- A Ditto Portal account with a configured Ditto Application (see Getting SDK Connection Details)
Get Started
1. Clone the Repository
- Open the terminal
- Clone the repository from GitHub.
git clone https://github.com/getditto/quickstart
- Navigate to the project directory:
cd quickstart
2. Configure Ditto
Get Ditto App ID, Playground Token, Auth URL, and Websocket URL
- Log in to your Ditto Portal account
- Navigate to your application and obtain the Ditto App ID, Playground Token, Auth URL, and Websocket URL. (see Getting SDK Connection Details for more details)
Add Ditto Credentials
- Copy the
.env.template
file at the top level of thequickstart
repo to.env
and add your app ID and online playground token. - Update the
.env
file with the App ID and Playground Token from your Ditto Application
3. Run the Application
1
Open the quickstart/java-spring
directory
2
Synchronize your project with the Gradle file by clicking Build > Sync Project with Gradle Files
3
Open a terminal and run the following command to launch the app: ./gradlew bootRun
4
Open http://localhost:8080 in a browser to interact with the app.
4. Sync-Data Offline
- Launch the application on multiple devices or simulators
- Disconnect from your current WiFi network while keeping WiFi enabled on the device to allow for LAN connections
- Add, edit, and delete tasks and experience offline collaboration!
Next Steps
All the Ditto Quickstart apps works together! Try running a quickstart app in other languages and see them all collaborate.
Additional Resources
Was this page helpful?