Restate Playground
Durable execution runtime for services, workflows, and agents.
📖 Overview
Restate is a durable execution runtime for services, workflows, and agents.
This playground gives you a single Restate Server running as a systemd service. It is intentionally Restate-only: no application service is deployed for you.
🔧 System Components
| Component | Port | Purpose |
|---|---|---|
| Restate ingress | 8080 | Invoke registered services |
| Restate Admin API and UI | 9070 | Manage deployments, inspect services, query state |
| Restate fabric | 5122 | Node control and metrics endpoint |
🛠️ Tools
restate: Restate CLI for service and deployment management.restatectl: Restate control CLI for node and cluster inspection.
🎯 Getting Started
Restate starts automatically. Begin by checking the service:
systemctl is-active restate
Check the Admin API:
curl -sf http://localhost:9070/health && echo OK
Inspect the Restate node:
restatectl status
Check the empty Restate state:
restate services list
Open the UI
Open the ui tab in the playground. It connects to Restate's Admin/UI endpoint on localhost:9070.
🔎 Inspect and Customize
| Item | Path or command |
|---|---|
| Restate config | /etc/restate/restate.toml |
| Restate data directory | /var/lib/restate |
| systemd unit | /etc/systemd/system/restate.service |
| Restate logs | journalctl -u restate -f |
Useful inspection commands:
sudo journalctl -u restate -n 100 --no-pager
cat /etc/restate/restate.toml
cat /etc/systemd/system/restate.service
After changing the Restate config, restart the service:
sudo systemctl restart restate
🧯 Troubleshooting
| Symptom | Likely cause | Check | Fix | Docs |
|---|---|---|---|---|
systemctl is-active restate is not active | Restate failed to start or restarted after a config error. | journalctl -u restate -n 100 --no-pager | Fix /etc/restate/restate.toml, then run sudo systemctl restart restate. | Server configuration |
curl -sf http://localhost:9070/health fails | Admin API is not listening yet or Restate is down. | `ss -ltnp | grep 9070` | Wait a few seconds, then check the Restate logs for startup errors. |
restate services list shows no services | No application service has been deployed or registered. | restate services list | Deploy and register your own Restate service. | List services |
| Data disappears after manual cleanup | /var/lib/restate was removed or reset. | sudo ls -la /var/lib/restate | Restart Restate and re-register your services. | Self-hosted Restate |
📚 Learn More
🧩 Related Content
🧪 Playgrounds
- Restate Cluster: a three-node Restate cluster for inspecting distributed behavior
Happy learning! 🚀
Actions
Restate Playground
Durable execution runtime for services, workflows, and agents.
📖 Overview
Restate is a durable execution runtime for services, workflows, and agents.
This playground gives you a single Restate Server running as a systemd service. It is intentionally Restate-only: no application service is deployed for you.
🔧 System Components
| Component | Port | Purpose |
|---|---|---|
| Restate ingress | 8080 | Invoke registered services |
| Restate Admin API and UI | 9070 | Manage deployments, inspect services, query state |
| Restate fabric | 5122 | Node control and metrics endpoint |
🛠️ Tools
restate: Restate CLI for service and deployment management.restatectl: Restate control CLI for node and cluster inspection.
🎯 Getting Started
Restate starts automatically. Begin by checking the service:
systemctl is-active restate
Check the Admin API:
curl -sf http://localhost:9070/health && echo OK
Inspect the Restate node:
restatectl status
Check the empty Restate state:
restate services list
Open the UI
Open the ui tab in the playground. It connects to Restate's Admin/UI endpoint on localhost:9070.
🔎 Inspect and Customize
| Item | Path or command |
|---|---|
| Restate config | /etc/restate/restate.toml |
| Restate data directory | /var/lib/restate |
| systemd unit | /etc/systemd/system/restate.service |
| Restate logs | journalctl -u restate -f |
Useful inspection commands:
sudo journalctl -u restate -n 100 --no-pager
cat /etc/restate/restate.toml
cat /etc/systemd/system/restate.service
After changing the Restate config, restart the service:
sudo systemctl restart restate
🧯 Troubleshooting
| Symptom | Likely cause | Check | Fix | Docs |
|---|---|---|---|---|
systemctl is-active restate is not active | Restate failed to start or restarted after a config error. | journalctl -u restate -n 100 --no-pager | Fix /etc/restate/restate.toml, then run sudo systemctl restart restate. | Server configuration |
curl -sf http://localhost:9070/health fails | Admin API is not listening yet or Restate is down. | `ss -ltnp | grep 9070` | Wait a few seconds, then check the Restate logs for startup errors. |
restate services list shows no services | No application service has been deployed or registered. | restate services list | Deploy and register your own Restate service. | List services |
| Data disappears after manual cleanup | /var/lib/restate was removed or reset. | sudo ls -la /var/lib/restate | Restart Restate and re-register your services. | Self-hosted Restate |
📚 Learn More
🧩 Related Content
🧪 Playgrounds
- Restate Cluster: a three-node Restate cluster for inspecting distributed behavior
Happy learning! 🚀