Server Setup

This checklist covers the implemented setup path for a Clocky server administrator.

Install

Select the intended server and review the application and bot permissions on Discord's authorization screen.

Verify

Test the core workflow in a channel where Clocky can respond:

/checkin
/status
/checkout
/stats period:week

If the commands do not appear, check Discord's application-command permissions and channel overrides before reinstalling.

Dashboard settings

Paid server administrators can configure these implemented settings in the Clocky dashboard:

  • Detailed or simple bot messages
  • A dedicated output channel
  • Break tracking on or off
  • Auto-checkout from 0 to 24 hours; 0 disables it

Free servers use the default 12-hour auto-checkout value.

Deletion requests

Administrators with Manage Server can inspect or change the server's stored deletion-request settings:

/admin-configure-deletion view-config
/admin-configure-deletion set-policy policy:immediate
/admin-configure-deletion set-policy policy:requires_approval

Use /admin-review-deletion-requests when the server requires administrator review. Clocky exposes additional grace-period and legal-retention fields, but the deployed member flow does not guarantee scheduled deletion, reminders, cancellation, archival, or restoration from those values.

See Deletion Request Settings.

Permissions

Basic tracking commands are available to members who can use Clocky's application commands. Billing, usage, and administrative commands use Discord's Manage Server permission or a stricter operational-owner check.

Clocky's bot role only needs View Channels, Send Messages, and Embed Links in the channels where it should operate. It does not need Administrator, Read Message History, or Message Content access.

For an older installation, review Server Settings → Roles → Clocky and remove unnecessary permissions. Do not remove intentional channel overrides; test /checkin and /checkout in the configured output channel after making a change.

After setup, share the Quick Start and Commands pages with members.

Was this page helpful?