General Information
Getting Started with Voltage
15min
using this guide, you'll be able to start a brand new team, spool up a lightning node, and go all the way to receiving your first lightning payment if you haven't already signed up for an account please create an account here here step 1 creating a team after you make an account, you will be greeted with the welcome! onboarding screen you will automatically have a team and the team name will be your email address click +new team if you would like to have another a team can be thought of as a sub account in which you can deploy infrastructure or invite collaborators click your account icon in the upper right and you will be able to access your account or documentation when you click the new team button, you will be asked to give your team a name and upload an image(optional) after you click continue you can then launch some infrastructure, edit your team, or invite others to your team if you invite others, make sure that they have an account made with voltage using their own unique login first before you can add more collaborators to your team, make sure they make an account on voltage first and verify their email through the signup process to add collaborators to your team, click the team option on the left side menu, and then add new user from there you can enter in the email of who you want to invite then you can give them specific permissions such as read only, etc when those are configured confirm the invite and send it and they will receive a team invite step 2 creating a node a node is your own server that is used to facilitate your transactions it's the cornerstone of all integrations with the lightning network once you are logged in, navigate to our nodes site at https //app voltage cloud https //app voltage cloud to start creating a new node, click the 'create node' button when asked what you want to deploy, select 'lightning node' you'll be asked what kind of node you want to create lightning nodes use a shared bitcoin node in most cases for more information on compute credits, check out our billing faq docid\ bxdqtwekk3kljsombqtfs if you are not ready to deploy a mainnet node, you can deploy a mutinynet test environment node instead! to do this click mutinynet as your node type on the deployment screen more information on mutinynet can be found here as a final step, you will be asked to give your node a name and password fill in the required fields and then click 'create' once more voltage can't see the password that you set and we are not able to recover a node due to a lost password due to this, please write down and safely secure your seed phrase immediately upon deploying your node! after you click 'create', you'll be directed to the node's primary voltage dashboard it typically takes 2 minutes or less to create a node and it will be ready to use right away as soon as the node's status hits running it's ready to use! step 3 creating a channel lightning channels are the way that nodes on the network are able to transact with each other you must create at least 1 payment channel to be able to send or receive transactions voltage offers free channel creation as part of the platform let's create a channel you can receive a payment! note the rest of this guide assumes you are on mainnet if you are running a mutinynet node, you can claim mutinynet coin from the faucet on the node dashboard after you click the 'yes, please' button, you should see a message that states your channel is opening your channel opening must go through a few steps to be broadcasted to the bitcoin network as soon as you reach the state of 'your new channel is pending', this means it's been successful but we need to wait for 3 onchain confirmations to use it to track the confirmations of the transactions click 'watch the process here' once the transaction has 3 confirmations, the channel is ready to use! you should see a message stating that the channel has been opened at this point we are ready to receive a payment we strongly recommend having more than just the free channel so your node is more reliable you can check out our outbound / inbound guides for more information step 4 generating an invoice in the lightning network, payments are facilitated by what's called invoices an invoice is just what it sounds like, a request for a payment from someone else let's generate an invoice so we can test receiving a payment to generate an invoice, you need to ask your node to generate one there is many ways to communicate with your node, including uis, apis, and clis for this tutorial, we'll us a ui tool called thunderhub if you want to learn how to use the apis, see step 6 to open the thunderhub instance for your node, click on the thunderhub icon on your dashboard to provision after a few seconds, it will show as running when you open up thunderhub, it will ask you for the node's password to unlock the thunderhub instance after it's unlocked, you'll be in the thunderhub ui which allows you to view information about your node, as well as perform actions let's generate an invoice here simply click the 'receive' button with a lightning bolt next to it to generate a lightning invoice it will ask for an amount you can enter any amount but let's use 1,000 in order to receive 1,000 sats then click 'create invoice' thunderhub will then create you an invoice and display it this is what you would give to someone else to pay so you can receive a payment you've successfully created an invoice! if you are running testnet, you can use a site like htlc me https //htlc me to send a testnet payment with this invoice open htlc me https //htlc me in another browser window and you should see a balance with a 'send' tab you can paste this invoice into the 'lightning request' field on the site in the send tab then click 'send payment' assuming a successful payment, you just made a lightning payment! now you can refresh your thunderhub dashboard and you should see a 1,000 sat balance in your wallet keep in mind that testnet can be unreliable and the payment may actually fail this does not mean that there is anything wrong with your node at this point you're using lightning! the steps below are optional but help you take the next steps in understanding you node and how to use it step 5 surge analytics (optional) now that you have a channel and you've made a payment, let's talk about how we can get better details about our node we've created a tool specifically for getting better data and insights from your node, called surge https //voltage cloud/surge you can install surge on your node to easily track transactions, view balances, and debug issues to install surge, navigate back to your node's home page at the top of your dashboard you will see a toggle to enable surge, flip the toggle on keep in mind that using surge consumes api credits after you toggle surge into the on position, you will get a pop up explaining what surge is and how it is used if you accept, enter your node password to confirm surge gives you all the details about what's happening inside of your node it's a single pane of glass into everything you'll need to know surge can take up to an hour to populate all the data because it's a time series solution learn more surge analytics faq docid\ tf70vt fuiqbxzrofhgm4 step 6 integrating with your node (optional) in step 4 we generated an invoice with thunderhub, a gui tool for your node while gui tools like thunderhub are helpful for management or maintenance of a node, most applications and services integrate with nodes via apis we expose both grpc and rest apis for the nodes that run inside of voltage and customers have access to all endpoints you can find the api documentation for your node here https //lightning engineering/api docs/api/lnd/ https //lightning engineering/api docs/api/lnd/ with the api you are able to programmatically open channels, send and receive payments, and much more additionally, given we expose the full lnd apis to our customers, you can connect any application, service, or tool into your voltage node that support the lnd apis these are things like lncli, mobile wallets, rebalancing tools, and more you can also find more developer information on our docs site under the developer resources category step 7 liquidity management tools (optional) as you start to send and receive more transactions, you'll likely need to start creating multiple payment channels to learn more about how to create and manage these payment channels, check out our inbound liquidity docid\ vlivlagn4rjdgtql5nvyw guide for automated liquidity services, check out voltage lsp docid\ m6u ouvdqxbiaywxfcgo for other ways to get liquidity, we recommend checking out lightning network + and amboss magma as well if you are looking to do liquidity swaps, you can use lightning terminal which is built in to your voltage node interface learn how to start terminal web docid\ bmsgsdjdmkqtgtejthyhe step 8 talk with our team (optional) our team is ready and eager to help with any of your questions or needs please contact us with any inquiries at hello\@voltage cloud mailto\ hello\@voltage cloud we are happy to work with you on your use case and understand how voltage can best serve you we additionally offer a full suite of management services under our enterprise license https //voltage cloud/enterprise license for technical support, fill out our support for at https //voltage cloud/support https //voltage cloud/support or email support\@voltage cloud mailto\ support\@voltage cloud we also have a fantastic community discord server https //voltage cloud/discord to chat with other voltage users or get developer assistance