Skip to content

Set up LogDog

Connect one Discord server to one VRChat group. Complete setup on the dashboard or with /setup in Discord. Both use the same configuration, so you can switch between them without starting over.

Requirements

Requirement Details
Your access Server owner or Administrator. Manage Server alone allows installation, but not configuration.
Your VRChat access Someone who can accept the join request (or invite the account) and assign a group role with View Audit Log.
LogDog in Discord View Channels, Send Messages, Embed Links, Attach Files, and Read Message History in log channels. Manage Channels to create channels.
LogDog in VRChat Group membership and View Audit Log.
Plan Free.

Have your group's id (grp_…) or the link from its page on vrchat.com (https://vrchat.com/home/group/grp_…) ready. A vrc.group share link will not work. See the permissions matrix for optional features.

Set up on the dashboard

The dashboard and LogDog's Discord messages count seven setup steps, because they also number the ones LogDog does by itself. Each section below says which of those steps it covers.

1. Select your server

Sign in to app.logdog.gg with Discord. Choose your server and follow the installation prompt if LogDog has not joined it yet. Keep the requested permissions selected. Open Setup for that server.

2. Choose your log channels

This is Step 1 and Step 2 on the dashboard.

Under Where should your logs go?, choose a layout:

Layout What it does
Express Creates a LogDog category with #vrc-requests for requests, #vrc-instance for instance activity, and #vrc-group for everything else.
Prebuilt Creates one channel per event category. Deselect categories you do not want.
Custom Uses existing channels. Choose a channel for each category, or leave a category blank to skip it.

Save your choices or create the channels using the button shown. Fix channel-permission warnings before continuing. After setup, Log Routing lets you change channels for whole categories or individual event types.

Check who can read your log channels

LogDog attempts to make new categories private to administrators. If Discord refuses the permission settings, LogDog may create a public category and show a warning. Make that category private before using it for staff logs. Existing channels keep their permissions. Add moderator roles to the channel permissions separately; LogDog feature grants do not make channels visible.

3. Connect your group

This is Step 3 and Step 4 on the dashboard.

Enter the group's id or its vrchat.com page link under VRChat group, then select Connect group. LogDog assigns a VRChat account and requests to join. One group can be connected to only one Discord server, and each server can connect only one group.

4. Let the account into your group

This is Step 5 and Step 6 on the dashboard and in Discord.

LogDog asks to join with the account it assigned. What you do depends on how your group takes new members:

Your group What to do
Takes join requests Accept the account's join request in VRChat. Waiting alone will not approve it.
Anyone can join Nothing. The account joins by itself.
Invite only Invite the account named in the Step 5 · Couldn't send a join request notice, which links to its VRChat profile. LogDog accepts the invite itself and setup carries on.
Closed Set the group to Invite Only in its settings, then invite the account named in the Step 5 · Your group is closed to new members notice.

LogDog checks every 10 minutes. Done already? Press I've done this, check now on the dashboard's setup page to check straight away. Setup notices are posted in Discord, and the dashboard bell shows the same instruction.

If LogDog's account is banned, or can't accept your invite

If the account is banned from your group, setup posts Step 5 · LogDog's account is banned from your group. Lift the ban, then invite the account.

If VRChat won't let the account accept your invite, for example because of an age gate or another join requirement, setup posts Step 6 · LogDog could not accept your invite. Once the account can join, press I've done this, check now and LogDog tries the invite again. If the invite has expired, invite the account again first.

Checks can take longer while VRChat is unavailable.

5. Grant audit-log access

This is Step 7 on the dashboard.

Give that account a group role with View Audit Log. Follow Grant audit-log access for the steps. The Discord notice Step 6 · Joined, one more step links there too.

LogDog checks every 10 minutes. Already granted it? Press I've done this, check now on the setup page. The page updates by itself while LogDog works, so there's no need to refresh it.

If access isn't granted, LogDog reminds you after 1 day and 7 days, in your setup channel and on the dashboard bell. After 30 days, it leaves the group and returns setup to the group step, with a notice saying why. Your channel settings are kept, and you can connect the group again when you're ready.

How often LogDog checks while it waits

LogDog checks every 10 minutes for the first hour, then hourly, then daily after a week. Pressing I've done this, check now restarts the 30-day clock and goes back to checking every 10 minutes for an hour.

Set up in Discord

Run /setup in a staff channel. Setup messages and progress updates are visible to people who can read that channel.

Choose Express, Prebuilt, or Custom, fix the permission checks, and enter your group. Then let the account into your group and grant audit-log access as described above. The I've done this, check now button is only on the dashboard's setup page; without it, setup carries on at LogDog's next check.

Discord setup also lets you put new channels inside an existing category and choose per-event channels during Custom setup. On the dashboard, configure per-event channels in Log Routing after setup.

Before connecting a group, Restart setup in Discord or Start over on the dashboard resets your channel selections. Once connected, use the configuration pages for changes.

First sync

Logs begin arriving in the channels you selected. Only the newest events are posted to Discord, 25 by default, so your channels don't fill up with old messages.

LogDog also imports the older audit history that VRChat still has for your group, on both Free and Premium, and keeps it for searching and stats on the dashboard. A long history arrives in batches over LogDog's first few checks. How far back it goes depends on VRChat.

What happens next

Confirm everything is working

Before handing LogDog over to your moderators, check that:

  • Setup is complete. The setup page confirms that the displayed VRChat account joined your group and its audit-log access was verified.
  • Diagnostics has no unresolved access problems for logging. Review Discord channel access and VRChat audit-log access. An unknown status is not confirmation of access.
  • A recent eligible event reaches the right Discord channel. Check VRChat Audit Logs and the configured destination. Allow a few minutes for polling; a quiet group may have no new events. Use No logs arriving if delivery is missing.
  • Your staff can read the intended channels. Check Discord channel permissions separately from LogDog's feature grants, and confirm private staff logs are hidden from members who should not see them.
  • A notification channel is selected. Choose a channel your administrators can read under Settings → Notifications for setup and access-loss notices.

Next, choose which logs to receive, give your staff access, and set a notification channel.

When those are done, you might also:

If setup does not advance, check the displayed account, its membership, and its assigned role. See Waiting for the account to join or Waiting for audit-log access for the next checks.