{"id":21992466,"url":"https://github.com/unyt-org/uix-template-deployment","last_synced_at":"2026-04-08T11:32:47.714Z","repository":{"id":264522563,"uuid":"869606579","full_name":"unyt-org/uix-template-deployment","owner":"unyt-org","description":"A UIX deployment demo","archived":false,"fork":false,"pushed_at":"2025-03-21T19:10:44.000Z","size":13,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T21:38:30.153Z","etag":null,"topics":["deployment","uix","uix-example"],"latest_commit_sha":null,"homepage":"https://uix.unyt.org/templates","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unyt-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["unyt-org"],"patreon":"unyt","custom":["https://unyt.org/donate","https://shop.unyt.org"]}},"created_at":"2024-10-08T15:21:46.000Z","updated_at":"2025-03-21T19:10:47.000Z","dependencies_parsed_at":"2024-11-24T20:55:31.408Z","dependency_job_id":"4cbc5ac2-7b12-4414-97b2-4731439b50c2","html_url":"https://github.com/unyt-org/uix-template-deployment","commit_stats":null,"previous_names":["unyt-org/uix-template-deployment"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/unyt-org/uix-template-deployment","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unyt-org%2Fuix-template-deployment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unyt-org%2Fuix-template-deployment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unyt-org%2Fuix-template-deployment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unyt-org%2Fuix-template-deployment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unyt-org","download_url":"https://codeload.github.com/unyt-org/uix-template-deployment/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unyt-org%2Fuix-template-deployment/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31554091,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deployment","uix","uix-example"],"created_at":"2024-11-29T20:13:51.326Z","updated_at":"2026-04-08T11:32:47.686Z","avatar_url":"https://github.com/unyt-org.png","language":"TypeScript","funding_links":["https://github.com/sponsors/unyt-org","https://patreon.com/unyt","https://unyt.org/donate","https://shop.unyt.org"],"categories":[],"sub_categories":[],"readme":"# UIX Template: Deployment\n\nDeploying [UIX](https://github.com/unyt-org/uix) apps is an essential part of\ntaking your project into production, and while the [unyt.app](https://unyt.app)\ninfrastructure is a great solution, there are several ways to host your own UIX\nprojects outside of it.\n\n**Note**: Unlike some frameworks, UIX doesn’t involve a traditional \"build\"\nprocess. UIX projects are designed to run directly using the `uix` command,\nwhich makes deployment straightforward. Instead of compiling your project,\nyou’ll be able to directly run it on any machine that has UIX installed.\n\nYou can upload your UIX project to your machine using tools like `scp`, serve\nUIX at a specific port using the `uix`-CLI and configure your backbone\ninfrastructure (such as `Nginx` reverse proxy) to forward incoming HTTP requests\nto the selected port. _Voilà - your app is live!_\n\nIf you don't like to setup all the infrastructure on your own, we recommend\ndeploying apps using the\n[UIX Docker Host](https://github.com/unyt-org/docker-host) inside containers for\nbetter portability and management.\n\n## Deploying UIX with the Docker Host\n\n\u003e [!NOTE]\n\u003e Docker Hosts are only support on Linux systems. If you experience some issues\n\u003e with your Linux distribution please let us know.\n\nFollow these steps to launch your UIX app in minutey. For more information check\nout the\n[Docker Host repository](https://github.com/unyt-org/docker-host/tree/v2).\n\n1. Install Docker on your server:\n\n   Follow the\n   [Docker installation guide](https://docs.docker.com/get-started/get-docker/)\n   for your server's operating system.\n2. Install the Docker Host Endpoint on your server:\n\n   ```bash\n   curl -s https://raw.githubusercontent.com/unyt-org/docker-host/main/setup.sh | bash -s @+YOUR_DOCKER_HOST\n   ```\n   Make sure to pass a unique\n   [endpoint id](https://docs.unyt.org/manual/datex/endpoints) to the install\n   script. The setup script will create a Docker Host instance by installing\n   [Deno](https://github.com/denoland/deno) and creating a persistent service\n   inside of `etc/systemd/system`.\n\n   You can check if the installation was successfull using the following\n   command:\n   ```bash\n   systemctl status unyt_docker_host_HOST_ENDPOINT.service\n   ```\n3. Configure your UIX app to use the Docker Host:\n\n   After setting up the Docker Host on your server, add the host endpoint as\n   location into your UIX apps `backend/.dx` configuration file.\n\n   ```datex title=\"backend/.dx\"\n   use stage from #public.uix;\n\n   endpoint: stage {\n   \tprod: @+your_app\n   },\n\n   location: stage {\n   \tprod: @+YOUR_DOCKER_HOST\n   },\n\n   domain: stage {\n   \tprod: 'YOUR-DOMAIN.com'\n   }\n   ```\n4. Deploy the UIX app into production on your local machine:\n\n   With the Docker host and `.dx` configured, deploy your app from your local\n   machine by running:\n   ```bash\n   uix --stage prod\n   ```\n\n   This command will deploy your UIX app to your custom Docker host, making it\n   live on your custom domain.\n\n\u003e [!WARNING]\n\u003e If the Docker Host you plan to deploy to has a access token configured, you\n\u003e need to pass this access token to UIX to make sure your app can\n\u003e authenticate.\u003cbr/\u003e You can set the access token as `HOST_TOKEN` environment\n\u003e variable on your local UIX projects console.\n\u003e\n\u003e ```bash\n\u003e export HOST_TOKEN=YOUR_TOKEN\n\u003e ```\n\n---\n\n\u003csub\u003e\u0026copy; unyt 2025 • [unyt.org](https://unyt.org)\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funyt-org%2Fuix-template-deployment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funyt-org%2Fuix-template-deployment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funyt-org%2Fuix-template-deployment/lists"}