You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit bd359a7
Browse filesBrowse the repository at this point in the historyBrowse files
<p>The app has three tabs along the bottom, <strong>Home</strong>, <strong>Containers</strong> and <strong>Panel</strong>, and a gear icon in the top right for <strong>Settings</strong>. This page goes through them in that order. If you have not installed a container yet, start with the <ahref="installation-android.html">installation guide</a>.</p>
<p>A status card says whether the backend is installed and up to date, which version it is, and whether the daemon is running. Below it are the number of installed and running containers and the device's kernel version, SELinux state, Android version and architecture. The card at the bottom opens the installation guide.</p>
85
85
<p>"Backend: Update available" appears after an app update. Tap it to install the new backend; running containers are not affected.</p>
<p>Every installed container has a card with its name, state, hostname, network mode, image size and resource limits, plus the options that are turned on. <strong>Start</strong> boots the container. A log window opens and shows the backend's output live, and you can close it once the operation finishes; <strong>Stop</strong> and <strong>Restart</strong> do the same. Once the container is running the card shows its PID and the buttons change to <strong>Stop</strong> and <strong>Restart</strong>.</p>
<p>A list of distributions built for Droidspaces, filtered to your device's architecture. Search by name. <strong>Download</strong> fetches the tarball into your Downloads folder and shows progress on the card; a notification tells you when it is done, and the button turns into <strong>Install</strong>. A download that fails gets a <strong>Retry</strong> button, and a tarball downloaded earlier is recognised the next time you open the sheet.</p>
108
108
<p><strong>Manage Repositories</strong> in the sheet's header lets you subscribe to other feeds that publish a <code>rootfs.json</code>. The Linux Containers mirror is the one worth adding, for distributions and versions the official repository does not build:</p>
<p>Picks a <code>.tar.xz</code> or <code>.tar.gz</code> rootfs archive from the phone's storage. A container exported from Droidspaces carries its settings and they are filled into the wizard, with a warning page first so you can review them. Any other rootfs tarball works too, as long as it has an init system.</p>
<p>Name and hostname, then the configuration form, then storage, then a summary. The <ahref="installation-android.html#the-setup-wizard">installation guide</a> walks through it, and <ahref="features.html">container settings</a> explains every toggle.</p>
<p>Only running containers appear here, each with its uptime, IP address, CPU and RAM. With a memory or CPU limit set, usage is shown against the limit. <strong>Terminal</strong> opens a shell straight from the card. Tapping anywhere else on the card opens the container's details.</p>
<p><strong>Systemd.</strong> The list shows every unit with its state and is filterable: all, enabled, disabled, masked, static, or units in an abnormal state. Each one can be started, stopped, restarted, enabled, disabled or masked, and <strong>View logs</strong> shows its journal. <strong>Inspect unit</strong> opens the unit's properties, dependencies and <code>systemctl status</code> output, and <strong>Edit override</strong> writes a drop-in for it, so you can change a service's settings from the phone without a text editor in the container.</p>
144
144
<p><strong>OpenRC</strong> and <strong>OpenWrt (procd)</strong> get the same list with start, stop, restart, enable and disable, and reload on OpenWrt.</p>
<p>The built-in terminal opens a shell in the container as the user you pick. Tabs are labelled <code>user@hostname</code>; the <strong>+</strong> tab opens another session, and asks for the user each time. Sessions run in a foreground service, so they survive leaving the screen, switching apps and the screen turning off, and the notification has an exit button and a wake lock toggle.</p>
151
151
<p>Pinch to zoom changes the text size. Tapping the terminal opens the keyboard. The <strong>Terminal</strong> page under <strong>Settings</strong> has the font, with a custom monospace font import, the starting text size, a dark mode for the terminal page only, a confirmation before a tab closes, and <strong>Open Keyboard On Tap</strong>. Turn that one off when you work in an editor, so a tap only moves the cursor; a keyboard button then appears in the terminal to open and close the keyboard.</p>
0 commit comments