{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/wallet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Initial setup","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"initial-setup","__idx":0},"children":["Initial setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide walks you through your first login to Wallet-as-a-Service (Palisade) and the key decisions you need to make before inviting your team."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-begin","__idx":1},"children":["Before you begin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An invitation email from Palisade"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A mobile device with an authenticator app (for example, Google Authenticator or Authy) for two-factor authentication (2FA)"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Didn't receive an invite?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check your spam folder. If you still can't find the email, contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@palisade.co"},"children":["support@palisade.co"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accept-your-invitation-and-sign-in","__idx":2},"children":["Accept your invitation and sign in"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the invitation email from Palisade."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the activation link."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set your password and configure two-factor authentication (2FA)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the Palisade console URL provided during onboarding."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enter Your Organization"]}," page, enter your organization name, then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your email address and password, then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the 2FA code from your authenticator app, then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For details on authentication methods including single sign-on, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/introduction/set-up-your-organization"},"children":["Create your organization"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-the-console","__idx":3},"children":["Use the console"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you sign in, the console displays the following main sections in the sidebar:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Home"]}," — View a summary of your organization's activity, including asset totals, vault and wallet counts, address book entries, and pending notifications."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vaults"]}," — Create and manage vaults and the wallets within them."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Controls"]}," — Configure approval groups (tab: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval groups"]},") and MPC quorums (tab: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MPC Quorums"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Devices"]}," — Add and manage mobile and CloudSign devices for MPC signing (tabs: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Internal"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["External"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connections"]}," — Open WalletConnect connections to external dapps."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Address book"]}," — Manage counterparties and their blockchain addresses (tabs: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Counterparties"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Addresses"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notifications"]}," — View pending approval requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," — Access organization management including ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User management"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API credentials"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhooks"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Backup & Recovery"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workflows"]}," (sweeps), and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audit logs"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Your organization starts empty"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A new organization has no vaults, wallets, devices, or policies configured. Use this guide and the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/admin-guide/admin-guide-overview#recommended-setup-order"},"children":["recommended setup order"]}," to build out each component."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"plan-your-organization-structure","__idx":4},"children":["Plan your organization structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you invite users or create wallets, decide on these key areas:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-method","__idx":5},"children":["Authentication method"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Palisade supports two authentication methods: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["username and password"]}," (the default) and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["single sign-on (SSO)"]}," with a third-party identity provider."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Choose before you invite"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Palisade locks the authentication method for each user when you send the invitation, and you can't change it afterward. If your organization uses SSO, configure it ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["before"]}," sending any invitations. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/admin-guide/configure-sso"},"children":["Configure single sign-on"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"role-assignments","__idx":6},"children":["Role assignments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Decide which roles your team members need. Palisade provides six roles:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Role"},"children":["Role"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Owner"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access to all features and settings, including organization-level configuration."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administrator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access to all features and settings. Cannot change organization-level settings."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Proposer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can manage wallets and initiate transactions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approver"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can review and approve transactions and other pending actions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Viewer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only access to wallets, transactions, and reports."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auditor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only audit access to organization activity and configurations."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At minimum, most organizations need:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2 owners or administrators"]}," for redundancy"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1 proposer"]}," to initiate transactions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2 approvers"]}," for multi-party approval"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"quorum-design","__idx":7},"children":["Quorum design"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Plan how you want to distribute MPC key shards across devices. Consider:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How many devices"]}," hold key shards (more devices = higher resilience)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How many devices"]}," must sign each transaction (higher threshold = stronger security)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Who controls"]}," each device (distribute across team members for separation of duties)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device types"]}," — mobile devices for manual review, CloudSign for automated signing, or a mix"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"approval-structure","__idx":8},"children":["Approval structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Decide which operations require human approval before they take effect:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transactions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Address book entries"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Policy rule changes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API credential creation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User invitations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Device registration"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-planning-an-organization","__idx":9},"children":["Example: planning an organization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A fintech company uses Palisade to manage institutional ETH and XRP custody. Their team has 6 people:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Person"},"children":["Person"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Role"},"children":["Role"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Responsibility"},"children":["Responsibility"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sarah (CTO)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Owner"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Organization settings, emergency access"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["James (Ops lead)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrator"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Day-to-day platform management"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maria (Trader)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Proposer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Initiates transactions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ravi (Trader)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Proposer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Initiates transactions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lisa (Compliance)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approver"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reviews and approves transactions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tom (Compliance)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approver"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reviews and approves transactions"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Their decisions:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," — SSO with Okta, configured before sending invitations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quorum design"]}," — one 3-of-5 Cloud quorum using CloudSign instances for automated signing. The higher threshold balances security with availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vault structure"]}," — two vaults: \"Hot Wallet Operations\" for daily trading and \"Cold Storage\" for reserve holdings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approval structure"]}," — transaction approval group with Lisa and Tom as approvers, threshold of 1. Address and policy approvals require both (threshold of 2) since these changes are less frequent but higher risk."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Policies"]}," — per-transaction limit of 50 ETH on hot wallets, rolling 24-hour limit of 500 ETH. Cold storage has lower limits and restricted destinations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Freeze controls"]}," — automatic freeze enabled on cold storage wallets for compliance review of every deposit."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This gives them separation of duties (traders propose, compliance approves), automated signing (CloudSign), and layered controls (policies + approvals + freeze)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":10},"children":["Next steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you have planned your organization structure, follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/admin-guide/admin-guide-overview#recommended-setup-order"},"children":["recommended setup order"]}," in the overview page to configure each component. The first step is to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/admin-guide/configure-sso"},"children":["Configure single sign-on"]}," if your organization uses SSO, or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/admin-guide/manage-users-and-roles"},"children":["Manage users and roles"]}," to invite your team."]}]},"headings":[{"value":"Initial setup","id":"initial-setup","depth":1},{"value":"Before you begin","id":"before-you-begin","depth":2},{"value":"Accept your invitation and sign in","id":"accept-your-invitation-and-sign-in","depth":2},{"value":"Use the console","id":"use-the-console","depth":2},{"value":"Plan your organization structure","id":"plan-your-organization-structure","depth":2},{"value":"Authentication method","id":"authentication-method","depth":3},{"value":"Role assignments","id":"role-assignments","depth":3},{"value":"Quorum design","id":"quorum-design","depth":3},{"value":"Approval structure","id":"approval-structure","depth":3},{"value":"Example: planning an organization","id":"example-planning-an-organization","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Initial setup","seo":{"title":"Initial setup"}},"lastModified":"2026-05-26T12:21:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/wallet/admin-guide/initial-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}