ship-deployment-guide

Deploy Urbit planets, comets, and fake ships on Ubuntu/Debian systems.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/toplyr-narfur/urbit-skills --skill ship-deployment-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-deployment-guide
Source: https://github.com/toplyr-narfur/urbit-skills/tree/main/skills/ship-deployment-guide
Command: npx skills add https://github.com/toplyr-narfur/urbit-skills --skill ship-deployment-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides step-by-step guidance for deploying various types of Urbit ships (planets, comets, fake ships) on bare-metal Ubuntu/Debian systems, ensuring production-ready configurations.

Core Features & Use Cases

  • Comprehensive Deployment: Covers planets (permanent identities), comets (free, ephemeral), and fake ships (offline development).
  • System Preparation: Includes validation of system requirements and dependency installation.
  • Network Configuration: Guides through firewall setup, port forwarding, DNS, and SSL/TLS.
  • Production Ready: Integrates with systemd for auto-starting services and includes validation steps.
  • Use Case: You need to deploy a new Urbit planet for your personal identity or a business application. This skill will walk you through every step from server setup to final validation.

Quick Start

Follow the steps in this skill to deploy a new Urbit planet on your Ubuntu server.

Frequently Asked Questions about ship-deployment-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an Urbit planet on a bare-metal Ubuntu server?

To deploy an Urbit planet on Ubuntu, you must prepare the system, install the Urbit binary, configure network settings like port forwarding, and integrate the ship with systemd for production reliability.

What is the difference between deploying Urbit comets and planets?

Urbit planets are permanent network identities requiring keyfile management, while comets are free, ephemeral identities. Both deployment processes involve similar system preparation but differ in keyfile acquisition and network validation steps.

Can I use systemd to auto-start my Urbit ship on Debian?

Yes, you can use systemd to auto-start your Urbit ship on Debian. The deployment process includes specific steps for creating systemd service files to ensure your planet or comet runs reliably in production.

How do I configure networking and firewall rules for an Urbit ship?

Configuring networking for an Urbit ship requires setting up firewall rules, configuring port forwarding, and establishing DNS with SSL/TLS to ensure secure and reliable external network connectivity for your server.

What are the limitations of deploying fake ships for offline Urbit development?

Fake ships are used strictly for offline Urbit development and testing. They do not require keyfile management or external network configuration, but they cannot interact with the live Urbit network as a planet or comet would.

Why does my Urbit planet deployment fail during keyfile management?

Urbit planet deployment can fail during keyfile management if the keyfile is missing, incorrectly formatted, or lacks proper permissions. Following the step-by-step deployment guide ensures correct keyfile installation and validation.